home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / comm / tt_104.zip / TT_104.DOC < prev    next >
Text File  |  1988-02-22  |  7KB  |  163 lines

  1. TinyTerm, version 1.04
  2. Copyright (C) 1988, George A. Stanislav
  3. All Rights Reserved
  4.  
  5. TinyTerm is a terminal emulator. It converts a personal computer into
  6. a dumb terminal. That means the computer will be able to call other
  7. computers, send text and control codes from them as well as receive
  8. the same back.
  9.  
  10. There are two types of emulation TinyTerm is capable of:
  11.  
  12.     1. ANSI BBS. This allows you to receive ANSI color codes from
  13. BBS and interpret them properly. TinyTerm sends these codes to the
  14. screen. To have them converted into colors, you must install
  15. ANSI.SYS. You can do that by adding the following line to the file
  16. called CONFIG.SYS:
  17.  
  18.     device=ansi.sys
  19.  
  20. For more information on ANSI.SYS consult your MS DOS manual.
  21.  
  22.     2. AVATAR - the Avanced Video Attribute Terminal. In this
  23. TinyTerm is somewhat ahead of its time. It can receive the advanced
  24. color codes developed by Wynn Wagner III and used by his Opus BBS
  25. program. Whenever the AVATAR emulator encounters the codes, it
  26. converts them into the appropriate ANSI codes. Since AVATAR codes are
  27. much more compact than ANSI codes, the AVATAR emulation allows for a
  28. faster transmission of screen controlling data.
  29.  
  30.     Here is a summary of AVATAR commands:
  31.  
  32.     ^v^a - tells AVATAR that the next character is a color code.
  33. AVATAR will translate it into <esc>[?;3?;4?m.
  34.  
  35.     ^v^b - turns blink on by translating to <esc>[5m.
  36.  
  37.     ^v^c - moves the cursor one line up - <esc>[1A.
  38.  
  39.     ^v^d - one line down - <esc>[1B.
  40.  
  41.     ^v^e - moves cursor one space left - <esc>[1D.
  42.  
  43.     ^v^f - one space right - <esc>[1C.
  44.  
  45.     ^v^g - clear to end of line - <esc>[K.
  46.  
  47.     ^v^h - locate a different cursor position. The next two
  48. characters are read and interpreted as binary representation of <row>
  49. and <column>.
  50.  
  51.     ^l   - clear the screen - <esc>[H<esc>[0;33;36m<esc>[2J<esc>J.
  52.  
  53.     ^y   - repeat character. AVATAR reads the next character and
  54. displays it repeatedly as instructed by the byte which is received
  55. immediately after the repeated character.
  56.  
  57. This information is given for reference only, a more detailed
  58. description is available in Opus documentation. It is not important
  59. for the user of this program to know anything about AVATAR emulation,
  60. it works automatically.
  61.  
  62. TinyTerm is tiny indeed. It only runs on COM1 at 300, 1200 and 2400
  63. baud. It is meant mostly to show how FOSSIL communications and AVATAR
  64. emulation can be programmed. TinyTerm does not support any file
  65. transfer on its own but will call Chuck Forsberg's program DSZ to do that.
  66. DSZ is a shareware program distributed separately. You can find it on many
  67. bulletin boards.
  68.  
  69. The function keys can be used to change the baud rate and parity.
  70. Some function keys are used as macros for Hayes compatible commands.
  71. For the list of commands press <F10>. If you are using an AT enhanced
  72. keyboard, you can use <F12> as well.
  73.  
  74. Version 1.03 added four new functions to TinyTerm - hardcoded keyboard
  75. macros, user configurable start-up defaults, support for external Zmodem
  76. file transfer and lowering the DTR which usually results in disconnecting.
  77.  
  78. The source code itself has no hardcoded macros, but leaves enough space
  79. in the program to include them. The advantage of hardcoded macros is that
  80. the program need not open and read any external files, it is all included.
  81. That's one of the advantages of being "tiny". There is an obvious dis-
  82. advantage to this approach: To have them hardcoded, you either have to
  83. include the macros in the source code and reassemble the program each time you
  84. want to modify the macros. Or you need an external utility to write your
  85. macros into TT.COM as if it were a file.
  86.  
  87. TTSETUP.COM is such a utility. Not only can you change the hardcoded macros
  88. to whatever you want, but you can change the defaults from 1200 baud,
  89. 8 bits, no parity and COM1 to something else. You can configure the
  90. program to run from COM1 - COM9, to initialize the modem to 300, 1200,
  91. 2400 or 9600 baud and to set parity to equal or none, with 7 or 8 stop
  92. bits respectively.
  93.  
  94. The macros are attached to the 10 function keys when pressed together
  95. with either the <ctl> or <alt> key. The TT.COM file distributed in the
  96. arc file already has one macro defined: <ctl> <F1> will dial my bulletin
  97. board if your modem uses Hayes commands. You can leave it that way or
  98. change it to whatever you want.
  99.  
  100. If you insert a vertical line in your macros, TTSETUP.COM will convert
  101. it into a carriage return before hardcoding it to TT.COM. For example:
  102.  
  103.     John Doe Y|Doey|
  104.  
  105. will be changed to: "John Doe Y<cr>Doey<cr>" which is the proper macro
  106. to log onto Opus BBS without letting anyone see your password.
  107.  
  108. You can use the macros for any string of characters: To dial a number,
  109. to send a code to your modem, to enter your password, whatever.
  110.  
  111. Version 1.03 of TinyTerm needed a program called ProZ.Com to be capable of
  112. Zmodem file transfers. ProZ in term would call DSZ. I decided this was a
  113. kludge - it got the thing done but was not elegant.
  114.  
  115. In version 1.04, TinyTerm will call DSZ by calling MS DOS. If you use a hard
  116. disk, this will be totally transparent to you. If you are a floppy user, make
  117. sure you have COMMAND.COM in the same drive and directory you booted the
  118. system from.
  119.  
  120. As long as I had to code the exec routine, I decided to add the possibility
  121. to drop to DOS temporarily and to call an external editor. The distribution
  122. copy of TinyTerm comes configured to call the BRIEF editor with MSGTEMP the
  123. file to edit. You can use any editor or word processor you wish (or any
  124. program or even batch file for that matter). Use TTSETUP to make the choice.
  125. As everything else in TinyTerm, your choice will be hardcoded in the program.
  126. That allows you to call TinyTerm anywhere on your system.
  127.  
  128. Now, assuming you have obtained a copy of either DSZ.COM or DSZ.EXE and have
  129. it somewhere on your path, and have set up the defaults for the editor, these
  130. are the commands to shell other programs:
  131.  
  132.     <Page Down>   - call DSZ for a Zmodem download,
  133.     <Page Up>     - same for upload,
  134.     <Ctrl> <PgDn> - Xmodem download,
  135.     <Ctrl> <PgUp> - Xmodem upload,
  136.     <Alt> <E>     - run the editor
  137.     <Alt> <D>     - drop to DOS (type EXIT to return).
  138.  
  139. By the way, TinyTerm does not tell DSZ which communications port to use.
  140. DSZ defaults to COM1 which can be changed using an environmental variable.
  141. Please refer to DSZ documentation. Also note that DSZ is copyrighted by
  142. Omen Technologies and you are expected to pay for its use. Please do not
  143. distribute DSZ in the same archive with TinyTerm.
  144.  
  145. You can drop the DTR (data terminal ready) by pressing <alt> <H>. This
  146. usually results in hanging up and disconnecting. Please notice the "usually."
  147.  
  148. TinyTerm uses FOSSIL to access the modem. To run this program you must
  149. have a FOSSIL driver installed. In fact, you need a new FOSSIL driver
  150. supporting draft 4, better yet draft 5 of FOSSIL specs. If your
  151. driver is too old, TinyTerm will tell you and refuse to run. If
  152. TinyTerm does not refuse to run, you have a proper version of FOSSIL.
  153.  
  154. TinyTerm achieves its tiny size by being written in assembly
  155. language. The full source code is included.
  156.  
  157. George Stanislav, the author of TinyTerm, makes no warranties or
  158. claims that TinyTerm will run and work on any equipment. He has
  159. tested it on his own equipment where it worked flawlessly. If you run
  160. TinyTerm, you do that fully at your own risk.
  161.  
  162.  
  163.